home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / mkmsgs.z / mkmsgs
Text File  |  1998-10-20  |  8KB  |  131 lines
  1.  
  2.  
  3.  
  4. mmmmkkkkmmmmssssggggssss((((1111))))                                                            mmmmkkkkmmmmssssggggssss((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_kkkk_mmmm_ssss_gggg_ssss - create message files for use by _gggg_eeee_tttt_tttt_xxxx_tttt
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _mmmm_kkkk_mmmm_ssss_gggg_ssss [_----_oooo] [_----_iiii _l_o_c_a_l_e] _i_n_p_u_t_s_t_r_i_n_g_s _m_s_g_f_i_l_e
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _mmmm_kkkk_mmmm_ssss_gggg_ssss utility is used to create a file of text strings that can be
  16.      accessed using the text retrieval tools [see _gggg_eeee_tttt_tttt_xxxx_tttt(1), _ssss_rrrr_cccc_hhhh_tttt_xxxx_tttt(1),
  17.      _eeee_xxxx_ssss_tttt_rrrr(1), and _gggg_eeee_tttt_tttt_xxxx_tttt(3C)].  It will take as input a file of text strings
  18.      for a particular geographic locale [see _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C)] and create a file
  19.      of text strings in a format that can be retrieved by both _gggg_eeee_tttt_tttt_xxxx_tttt(1) and
  20.      _gggg_eeee_tttt_tttt_xxxx_tttt(3C).  By using the _----_iiii option, you can install the created file
  21.      under the _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS directory (_l_o_c_a_l_e
  22.      corresponds to the language in which the text strings are written).
  23.  
  24.      _i_n_p_u_t_s_t_r_i_n_g_s
  25.                  the name of the file that contains the original text strings.
  26.  
  27.      _m_s_g_f_i_l_e     the name of the output file where _mmmm_kkkk_mmmm_ssss_gggg_ssss writes the strings
  28.                  in a format that is readable by _gggg_eeee_tttt_tttt_xxxx_tttt(1) and _gggg_eeee_tttt_tttt_xxxx_tttt(3C).
  29.                  The name of _m_s_g_f_i_l_e can be up to 14 characters in length, but
  30.                  may not contain either \_0000 (null) or the ASCII code for _////
  31.                  (slash) or _::::  (colon).
  32.  
  33.      _----_iiii _l_o_c_a_l_e   install _m_s_g_f_i_l_e in the _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS
  34.                  directory.  Only super-user user or a member of group _bbbb_iiii_nnnn can
  35.                  create or overwrite files in this directory.  Directories
  36.                  under _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee will be created if they don't exist.
  37.  
  38.      _----_oooo          overwrite _m_s_g_f_i_l_e, if it exists.
  39.  
  40.      The input file contains a set of text strings for the particular
  41.      geographic locale.  Text strings are separated by a newline character.
  42.      Nongraphic characters must be represented as alphabetic escape sequences.
  43.      Messages are transformed and copied sequentially from _i_n_p_u_t_s_t_r_i_n_g_s to
  44.      _m_s_g_f_i_l_e.  To generate an empty message in _m_s_g_f_i_l_e, leave an empty line at
  45.      the correct place in _i_n_p_u_t_s_t_r_i_n_g_s.
  46.  
  47.      Strings can be changed simply by editing the file _i_n_p_u_t_s_t_r_i_n_g_s.  New
  48.      strings must be added only at the end of the file; then a new _m_s_g_f_i_l_e
  49.      file must be created and installed in the correct place.  If this
  50.      procedure is not followed, the retrieval function will retrieve the wrong
  51.      string and software compatibility will be broken.
  52.  
  53. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  54.      The following example shows an input message source file _CCCC_...._ssss_tttt_rrrr:
  55.           _FFFF_iiii_llll_eeee _%%%%_ssss_::::_\\\\_tttt _cccc_aaaa_nnnn_nnnn_oooo_tttt _bbbb_eeee _oooo_pppp_eeee_nnnn_eeee_dddd_\\\\_nnnn
  56.           _%%%%_ssss_:::: _BBBB_aaaa_dddd _dddd_iiii_rrrr_eeee_cccc_tttt_oooo_rrrr_yyyy_\\\\_nnnn
  57.                _....
  58.                _....
  59.                _....
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. mmmmkkkkmmmmssssggggssss((((1111))))                                                            mmmmkkkkmmmmssssggggssss((((1111))))
  70.  
  71.  
  72.  
  73.           _wwww_rrrr_iiii_tttt_eeee _eeee_rrrr_rrrr_oooo_rrrr_\\\\_nnnn
  74.                _....
  75.                _....
  76.  
  77.      The following command uses the input strings from _CCCC_...._ssss_tttt_rrrr to create text
  78.      strings in the appropriate format in the file _UUUU_XXXX in the current
  79.      directory:
  80.           _mmmm_kkkk_mmmm_ssss_gggg_ssss _CCCC_...._ssss_tttt_rrrr _UUUU_XXXX
  81.  
  82.      The following command uses the input strings from _FFFF_RRRR_...._ssss_tttt_rrrr to create text
  83.      strings in the appropriate format in the file _UUUU_XXXX in the directory
  84.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_ffff_rrrr_eeee_nnnn_cccc_hhhh_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_////_UUUU_XXXX.
  85.           _mmmm_kkkk_mmmm_ssss_gggg_ssss _----_iiii _ffff_rrrr_eeee_nnnn_cccc_hhhh _FFFF_RRRR_...._ssss_tttt_rrrr _UUUU_XXXX
  86.  
  87.      These text strings would be accessed if you had set the environment
  88.      variable _LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_====_ffff_rrrr_eeee_nnnn_cccc_hhhh and then invoked one of the text retrieval
  89.      tools listed at the beginning of the DESCRIPTION section.
  90.  
  91. FFFFIIIILLLLEEEESSSS
  92.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_////_****   message files created by _mmmm_kkkk_mmmm_ssss_gggg_ssss
  93.  
  94. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  95.      _eeee_xxxx_ssss_tttt_rrrr(1), _gggg_eeee_tttt_tttt_xxxx_tttt(1), _ssss_rrrr_cccc_hhhh_tttt_xxxx_tttt(1), _gggg_eeee_tttt_tttt_xxxx_tttt(3C), _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C)
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.